home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 5 / The 640 Meg Shareware Studio CD-ROM Volume V (Data Express)(1994).ISO / text / pcb_dir.doc < prev    next >
Text File  |  1994-07-15  |  5KB  |  107 lines
  1.  +--------------------------[ PCB_DIR  Ver 1.00 ]----------------------------+
  2.  |  Written By Gary Meeker 06/15/94                        Updated   /  /    |
  3.  |  SYSOP: SHARP Technical Support Line BBS               Lawrenceville, GA  |
  4.  |         (404) 962-1788                          300-14400 Baud. 24 Hours  |
  5.  +---------------------------------------------------------------------------+
  6.  V1.00 06/15/94 - Initial release
  7.  
  8.  
  9.  Syntax: PCB_DIR Dirs [DirLst] [/Z] [/3]
  10.  
  11.  Where:    Dirs = Drive:\Path to DIRxx files
  12.        [DirLst] = Drive:\Path to DIR & DIR.LST files if different
  13.  
  14.            [/3] = Generate 3 Columns instead of 2 in DIR file
  15.            [/Z] = Use Zeros to pad the DIR1 - DIR9 files
  16.  
  17. The '[' & ']' indicate optional parameters and these characters are not
  18. actually to be used.
  19.  
  20. Example Usage:
  21.  
  22.    DIR_LST C:\PCB\CDROM
  23.  
  24. This will copy the FILES.xxx directory listings to C:\PCB\CDROM\DIRxx and
  25. create the DIR.LST, DIR & DIRG files in the C:\PCB\CDROM directory with
  26. the default 2 column DIR & DIRG files.
  27.  
  28.    DIR_LST D:\CDROM\1 C:\PCB\CDROM /3
  29.  
  30. This will copy the FILES.xxx directory listings to D:\CDROM\DIRxx and create
  31. the DIR.LST, DIR & DIRG files in the C:\PCB\CDROM directory with 3 column
  32. DIR & DIRG files.
  33.  
  34. This program is designed to be run directly from the CD-Rom and will
  35. copy the FILES.xxx to DIRxx files and generate a DIR.LST, DIR & DIRG file
  36. in the specified directory.
  37.  
  38. You may create the DIR & DIRG files in 2 (default) or 3 column formats.
  39. The DIRG will be colorized with PCBoard's @Xnn color and can be renamed
  40. DIR as PCBoard will strip the codes for non-graphic Users.    The color
  41. coding and design is controlled by a configuration file named PCB_DIR.CFG
  42. and you can copy this file to the Dirs or DirLst directory and customize
  43. it before running the program. The format is as follows:
  44.  
  45. Line 1: Maximum Directory Digits (2 = 01-99, 3 = 001-999)
  46. Line 2: Frame Characters (TopLeft, TopRight, BotLeft, BotRight, Horiz, Vert)
  47. Line 3: Colors (Frame Color, Digit Color, Cycle, NumColors, Color Codes, ....)
  48.  
  49. Frame Characters are specified in Decimal
  50.  
  51.      196             205             205             196
  52.  218┌───┐191     201╔═══╗187     213╒═══╕184     214╓───╖183
  53.  179│   │        186║   ║        179│   │        186║   ║
  54.  192└───┘217     200╚═══╝188     212╘═══╛190     211╙───╜189
  55.  
  56. Frame Color & Digit Color are specified using PCBoard's @Xnn codes. Digit
  57.    Color refers to the color of the Directory Number column.
  58.  
  59. Cycle refers to how many descriptions are printed in a color before moving
  60.    on to the next color.
  61.  
  62. NumColors is the number of colors to cycle through.
  63.  
  64. Color Codes is a list of color codes in PCBoard's @Xnn and must match the
  65.    number specified by numColors.
  66.  
  67. Using /Z will rename FILES.001 to DIR01 instead of DIR1 to maintain a
  68. constant length of file names and to assist in proper sorting of the
  69. DIRxx files by directory sorting utilities.
  70.  
  71. The program depends on a DIR.TXT file existing on the CD-ROM in the current
  72. directory. The format of the file is as follows.
  73.  
  74.  Value                                ┌─────── Hard Disk Subdirectory written
  75.  Ignored                              │        to DIR.LST - 30 Characters Max
  76.  └─                                ───┴────
  77. [nn] Windows Application Utilities \WIN\APP
  78.    ─────────────┬────────────────
  79. │  │              │                │
  80. │  │              │                └─ Used to determine end of Description
  81. │  │              │                   and start of Subdirectory
  82. │  │              │
  83. │  │              └─ Description of Directory Content written
  84. │  │                 to DIR.LST - 35 Characters Max
  85. │  │
  86. │  └─ Used to determine start of Description.
  87. │
  88. └──── Column 1 must start with this.
  89.  
  90. The Description is determined to start 2 characters after the ']' and end
  91. 1 character before the '\' and the Subdirectory starts at the '\'.   Only
  92. lines containing the '[', ']' & '\' will be used and counted.  The number
  93. between the '[' & ']' is ignored and the actual number of the line in the
  94. file is used instead.  The Sort field is always set to '0'.
  95.  
  96. In 2 Column mode, 30 of the 35 allowable characters are written to the
  97. DIR & DIRG files and in 3 Column mode, 21 characters are used.
  98.  
  99. This is just a quick & easy way to get the files generated without a lot
  100. of manual work involved.  The program is FREEWARE and can be distributed
  101. freely or used on any CD-ROM which can benefit from it.   It was written
  102. specifically for the Shareware Studio series of CD-ROM's as they contain
  103. a DIR.TXT file and the FILES.nnn directory listing files.
  104.  
  105. Please direct any questions or comments to my BBS or on SaltAir BBS as I
  106. check in there daily.
  107.